home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / phonev4.arc / PHONEV4.DOC < prev    next >
Text File  |  1991-05-07  |  4KB  |  122 lines
  1. PHONEV4.COM -  Version 4 of PHONE!!!!!!!!  (8088 compatible)    July 21, 1990
  2.  
  3.  
  4. Here's the source code and ready to run .COM file for my Phone line monitor
  5. program...........
  6.  
  7. I have revised the PHONE program in several ways from previous releases. The
  8. previous releases were having difficulty running on 8088 based machines. This
  9. was due to some trickery in interrupt vector table.
  10.  
  11. The 80286/80386 BIOS initializes unused interrupts to point to a IRET statement,
  12. the 88 BIOS does not. Therefore, when my program called an interrupt to check
  13. for previous installation, the 8088 machines would crash. I have discontinued
  14. using this method of checking for previous installation, PHONEV4 will run on any
  15. IBM PC or compatible.
  16.  
  17. new syntax:
  18.  
  19. phonev4 /p## /r## [/s] [/u]
  20.  
  21. /p - port number 1 thru 4
  22. /r - # of rings 1 thru 99
  23. /s - sound on or off, (tone when phone is ringing)
  24. /u - uninstall 
  25.  
  26.  
  27. Remember that the system will reboot when the number of unanswered rings
  28. EXCEEDS the trigger-point you have specified.
  29.  
  30.  
  31. Example: to monitor COM1 and reboot on unanswered ring number 7, use the
  32. following command line.
  33.  
  34. PHONEV4 /p1 /r6
  35.  
  36.  
  37. Just run it before the BBS..... It goes TSR, and if the phone line rings more
  38. times than the number you specified, without having seen a carrier in between,
  39. then the computer executes a reset, the same LOW-LEVEL reboot that //REBOOT
  40. performs (WWIV SysOp command to reboot the system)........ Keep in mind that
  41. this will only be helpful IF your BBS is booted from your AUTOEXEC.BAT file.
  42.  
  43. Here's an example of an AUTOEXEC.BAT file which will work with PHONEV4.COM:
  44.  
  45. Echo Off
  46. Path=C:\;C:\DOS
  47. Prompt $P$G
  48. PHONEV4 /p2 /r6
  49. cd \BBS
  50. BBS
  51. <End of File>
  52.  
  53.  
  54. The preceding AUTOEXEC.BAT sets the PHONEV4 program to monitor COM2 and reboot
  55. on unanswered ring number 7.
  56.  
  57. I have not yet tested it on COM1, but it works fine on COM2.....
  58.  
  59. Unanswered rings are cumulative...... the counter is zeroed out when a carrier
  60. is detected....So, for example, suppose 9 rings was specified as the
  61. trigger-point :
  62.  
  63. Caller A lets it ring 4 times, the gives up..
  64.  
  65. Caller B lets it ring 4 more times then gives up.
  66.  
  67. Caller C will reboot the system on his SECOND ring (4+4+2=10 which EXCEEDS 9)..
  68.  
  69. If either Caller A or Caller B had received a carrier, the ring counter
  70. would have been reset, and the system would have to wait for 9 unanswered rings
  71. to occur......
  72.  
  73. The amount of time elapsed between the three calls is irrelevent. The improtant
  74. factors are:
  75.  
  76. 1) whether or not ANY carrier had been detected (incoming OR outgoing calls)
  77. 2) whether or not the machine had been rebooted by some other mechanism
  78. 3) trigchg has been run (remember, trigchg is only for use on 286/386 machines)
  79.  
  80. Those are the only three conditions that will cause the program to re-set its
  81. count of unanswered rings (i.e. start counting from zero again).
  82.  
  83. I have not yet tested it out on a PS\2 yet either, but I don't see why it
  84. wouldn't work.. I don't do anything strange in the BIOS.... I just use regular
  85. COMPORT addressing..
  86.  
  87. I figure if WWIV will run on a PS\2, then this will also.....
  88.  
  89.  
  90. NOTE:
  91.  
  92. The com ports MUST follow standard convention. This means that:
  93.  
  94. COM1 == 03f8h
  95. COM2 == 02f8h
  96. COM3 == 03e8h
  97. COM4 == 02e8h
  98.  
  99. If you are using COM3, but have it configured with a base port address as
  100. 02e8h, just LIE to my program , and tell it COM4. (I don't know anybody who
  101. uses nonstandard com port base addressing, but I am sure they're out there).
  102. If you use some OTHER base port address, and you have a copy of my source code,
  103. just replace one of the above listed comport base addresses with the address
  104. you use, re-assemble/link the program, and tell my program the COM number of
  105. the COMport whose address you changed.
  106.  
  107.  
  108. SPECIAL USAGE -
  109.  
  110. PHONEV4 /s
  111.  
  112. When PHONEV4 is already installed, the above command line will cause it to
  113. toggle the "sound activity" (i.e. if its on, turn it off... if its off, turn it
  114. on).
  115.  
  116.  
  117. Scott........
  118.  
  119. Computer from Hell   1@13121 WWIVLink
  120. ██████████████████   The Depths of Hell BBS
  121.                      (301) 638-0211
  122.